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1. Introdução 


O objetivo deste manual é orientar as Unidades da Federação (Estados), a 
consumirem de forma automatizada e padronizada, os dados de notificação de 
COVID-19 e informações sobre o LEITOS, garantindo consistência das 
informações. 


2. Utilização da API 


API é um conjunto de rotinas e padrões de programação para acesso a um 
aplicativo de software ou plataforma baseado na Web. A sigla API refere-se ao 
termo em inglês "Application Programming Interface" que significa em tradução 
para o português "Interface de Programação de Aplicativos”. 


Através das APIs, os aplicativos podem se comunicar uns com os outros sem 
conhecimento ou intervenção dos usuários. Elas funcionam através da 
comunicação de diversos códigos, definindo comportamentos específicos de 
determinado objeto em uma interface. 


2.1. Campos Contidos na API 


Os campos abaixo, são informações disponibilizadas para LEITOS. 
“ index” : "leitos-ac”, 

" type" :" doc”, 

"id": "4Pm-n3]BgsCGahDPwvViA", 

" score" : 1.0, 

“Source”: ( 

"estado" : "Acre”, 

"estadoSigla" : "AC", 

"municipio" : "Assis Brasil", 

"cnes" : "2001020", 

"nomeCnes" : "UNIDADE MISTA DE ASSIS BRASIL”, 

"dataNotificacao" : "2020-06-03705:00:00.0002Z", 

"dataAtualizacao" : "2020-06-03720:12:40.3122”, 

"ofertaHospCli" : 12, 

"ofertaHospUti" : 0, 

"ofertaSRAGClIi" : O, 

"ofertaSRAGU" : 0, 

"ocupHospCli" : 1, 

"ocupHospuUti" : O, 

"ocupSRAGCIi" : O, 

"ocupSRAGUi" : 0, 

“altas” : 16, 

"obitos” : 6, 

"ocupacaolInformada" : true 
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2.2. URL para consumo da API 


Para consumir os dados disponibilizados pela API, utilizaremos a seguinte URL: 


https://elasticsearch-saps.saude.gov.br/leitos-uf/ search?pretty 


2.3. Nomenclatura dos campos de Notificações 


A URL retorna os campos listados abaixo no formato .JSON, o qual, poderá ser 
utilizado por qualquer ferramenta que consiga manipular dados em .JSON. 


Exemplo: index notificações-esusve* 
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2.3.1. Dicionário dos dados de notificação 


Esta seção descreve o dicionário dos dados da tela do sistema e-SUS VE relativa 
ao cadastramento de notificações. 
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ao a Informações do Elastic que informa qual o index 
Objetivo: , 
está sendo consultado 
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Campo API - type 
Obiaiivá: Informações do Elastic que informa qual o tipo 
da de documento que está sendo consultado 
Campo API ER 
gado String que informa a chave especifica do 
Objetivo: 
Re cpisiador 
Campo API * score 
no Informação do Elastic que concede uma pontuação 
Objetivo: 5 
quando a informação é pesquisada 
Campo API * source 
a Array que contem um conjunto de dados 
Objetivo: 
recuperados. 
Campo API estado 
Objetivo: String 
Campo API estadoSigla 
Objetivo: String 
Campo API municipio 
Objetivo: String 
Campo API cnes 
Objetivo: String 
Campo API nomeCnes 
Valores possíveis Datetime 
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Campo API dataAtualizacao 
Valores possíveis Datetime 

Campo API ofertaHospCli 
Valores possíveis String 

Campo API ofertaHospUti 
Valores possíveis Simao) 

Campo API ofertaSRAGCli 
Valores possíveis String 

Campo API ofertaSRAGUti 
Valores possíveis Sicisilmio) 
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Campo API ocupHospCli 
Valores possíveis String 
Campo API ocupHospUti 
Valores possíveis Str iimao) 
Campo API ocupSRAGCI i 
Valores possíveis String 
Campo API ocupSRAGUti 
Valores possíveis String 
Campo API altas 
Valores possíveis Siri) 
Campo API obitos 
Valores possíveis String 
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3. Configurando para Consumir Informações da API 


Para saber se o arquivo foi carregado com sucesso use o seguinte comando: 
O documento irá auxiliar no consumo de dados da API via GET e POST utilizando o sistema do POSTMAN. 


1. Ao acesso o POSTMAN, Criaremos uma aba para executar um comando em GET, esse comando ira consultar no máximo 
10 mil registro. 
a. Configuraões: 
i. Authorization: Basic Auth 
1. Username e Password 


» Elastic - API - 1º Passo 4 E comments O Examples O v 
GET Y | https://elasticsearch-saps.saude.gov.br/esusve-ce/ search?pretty Save v 
Params 6 Authorization € Headers (8) Body Pre-request Script Tests Settings Cookies Code 
TYPE Q Heads up! These parameters hold sensitive data. To keep this data secure while working in a collaborative environment, we recommend using x 

- - - ariables. Learn more about variables 


Userna 
generated when you send the request. Learn more username 
about authorization 

Password | 


Show Password 
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b. Após o preenchimento dos dados, o sistema irá retornará até 10 mil registro. 


» Elastic - API - 1º Passo E comments 0 Examples O v 
GET Y | https://elasticsearch-saps.saude.gov.br/esusve-ce/ search?pretty Save v 
Params € Authorization O Headers (8) Body Pre-request Script Tests Settings Cookies Code 





Query Params 


KEY VALUE DESCRIPTION ... Bulk Edit 
pretty 
Body Cookies (1) Headers (8) Test Results Status: 2000K Time: 62ms Size: 17.13 KB Save Response vw 
Pretty Raw Preview Visualize JSON vw E mm Q 
1 E E 
2 "EooKk”: 3; 
3 “timed out”: false, 
4 “ shards": 1 
5 “total”: 1, 
6 "successful": 1, 
7 “skipped"”: O, 
8 “failed”: O 
9 p 
19 “hits”: 1 
11 “total": 1 
12 “value”: 10000, 
13 “relation”: “gte” 
14 » 
15 “max score": 1.0, 
16 “háts": [ 
17 f 
18 “ index": “esusve-ce”, 
19 " type": " doc”, 
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2. Para consultar acima de 10 mil registro é necessário utilizar a funcionalidade do Scroll do Elastic. Essa funcionalidade irá 
recuperar 10 mil registro a cada requisição, logo, se tiver 70 mil registro em um índice, terá que executar uma consulta com o 
Scroll 7 vezes. 

a. Utilizando o POSTMAN, criamos uma nova ABA para utilização do POST 
b. Configuraões: 
i. Authorization: Basic Auth 
1. Username e Password 
ii. Body 
1. Marcar a Opção raw 
2. Marcar a opção de escrita para JSON 


> Elastic - API - 2º Passo 


POST v https://elasticsearch-saps.saude.gov.br/esusve-ce/ search?scroll=1 m&pretty 
Params € Authorization € Headers (9) Body Pre-request Script Tests Settings 
ED DJÕÃÕÃÃO 
none form-data x-www-form-urlencoded o raw binary GraphQL JSON vw 
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c. Após esse processo temos que adicionar as seguintes variáveis no JSON 
r 


“e ah 

2 “size”: 500, 
é “query”: | 

4 “match all!':() 


, 


; 
ii Com o código acima, poderá também realizar pesquisas para um determinado campo do índice, conforme 
imagem abaixo: 


17 [ 
2 “size”: 500, 
3” "query": | 
4. “match” :f 
“municipioNotificacao":"Fortaleza! 
; 
> 
d. Após a inclusão do código, irá retornar os dados, conforme abaixo: 
1 | 
2 “ scroll id": "DXF1ZXISQW5kRmVOY2gBAAAAAAAFBd8WZ1ZuMm9FRDITdnVDN2IzUGAWRGZrZw==", 
3 “took”: 19, 
4 “timed out": false, 
5 
6 
7 
8 
E 
10 


“ shards": 1 
“total”: 1, 
"successful": 1, 
“skipped": 0, 
“failed”: O 
:, 
11 “hits: | 
12 "total": 1 
13 “value”: 11511, 
14 “relation”: “eq” 
15 E” 
16 “max score": 0.32738438, 
17 “hits | 
18 f 
19 “" index": “esusve-ce”, 
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3. Após a pesquisa, caso possua mais de 10Omil registros, deverá realizar a pagina do scrolling para que a API retorne os demais 
dados 
a. Criamos uma ABA no POSTMAN e incluímos os dados: 
b. Configuraões: 
i. Authorization: Basic Auth 
1. Username e Password 
ii. Body 
1. Marcar a Opção raw 
2. Marcar a opção de escrita para JSON 
c. No campo de inclusão do código, colocar os seguintes dados: 


l 
“scroll”: “Im” 


+ 
“scroll id": "DXFIZXISQUSkRmVOY2gBAAAAAAAEO9AWZzFXQkISQXVRVTZmVF JviWllanIydw==" 
) 


i. Atag do SCROLL ID ela é recuperada do PASSO 2, que retorna a tag SCROLL ID, essa informação que irá 
fazer com que o scrolling realize o retorno dos dados de 10 em 10 mil. 
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d. Abaixo segue a consulta e o retorno da API: 


» Elastic - API - 3º Passo 





POST Y | https://elasticsearch-saps.saude.gov.br/ search/scroll 

Params Authorization € Headers (10) Body € Pre-request Script Tests Settings 
none form-data x-www-form-urlencoded O raw binary GraphQL  JSON 

Tc 

2 “seroll": “Im”, 

3 “scroll id": “DXF1ZXISQW5kRmVOY2gBAAAAAAAFDRYWZ1ZuMm9FRDITdnVDN2]zUGANRGZr Zw==|" 

43 


3ody Cookies (1) Headers (8) Test Results 





Pretty Raw Preview Visualize JSON vw — 
1 
2 " scroll id": “DXFIZXISQUS5kRmVOY2gBAAAAAAAFDRYWZ1ZuMm9FRDITdnVDN2IzUGAWRGZrZw==" 
3 "took": 18, 
4 “timed out": false, 
5 “ shards": 1 
6 “total”: 1, 
7 “successful”: 1, 
8 “skipped": 0, 
9 “failed”: O 
10 E 
11 “hits”: [ 
12 “total”: 1 
13 “value”: 11511, 
14 “relation”: "eg" 


“ 


Stat 


s: 200 OK 


T 


Ea Comments O 


me: 142ms 


1. Nesse 3º passo a URL muda, não precisa mais passar o índice pela URL. 
2. Atag SCROLL ID ela é dinâmica, para cada consulta tem que incluiro SCROLL ID da anterior. 


Examples O v 


Size: 585.97 KB 


Cookies Code 


Beautify 


Save Response vw 


m Q 
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